<!DOCTYPE html>



  


<html class="theme-next mist use-motion" lang="zh-Hans">
<head>
  <meta charset="UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>
<meta name="theme-color" content="#222">









<meta http-equiv="Cache-Control" content="no-transform" />
<meta http-equiv="Cache-Control" content="no-siteapp" />
















  
  
  <link href="/lib/fancybox/source/jquery.fancybox.css?v=2.1.5" rel="stylesheet" type="text/css" />







<link href="/lib/font-awesome/css/font-awesome.min.css?v=4.6.2" rel="stylesheet" type="text/css" />

<link href="/css/main.css?v=5.1.4" rel="stylesheet" type="text/css" />


  <link rel="apple-touch-icon" sizes="180x180" href="/images/apple-touch-icon-next.png?v=5.1.4">


  <link rel="icon" type="image/png" sizes="32x32" href="/images/favicon-32x32-next.png?v=5.1.4">


  <link rel="icon" type="image/png" sizes="16x16" href="/images/favicon-16x16-next.png?v=5.1.4">


  <link rel="mask-icon" href="/images/logo.svg?v=5.1.4" color="#222">





  <meta name="keywords" content="Hexo, NexT" />










<meta name="description" content="dubbo:service(dubbo:service)这个配置是针对服务端的，用来暴露服务端可以对外提供的服务信息  对应的配置类com.alibaba.dubbo.config.ServiceConfig     属性 对应URL 类型 是否必填 缺省值 作用 描述 兼容性     interface - class 必填 - 服务发现 服务接口名 1.0.0以上版本    ref - obj">
<meta property="og:type" content="article">
<meta property="og:title" content="kyssion-blog">
<meta property="og:url" content="http://yoursite.com/2018/10/09/dubbo学习和使用（八）dubbo配置参考/index.html">
<meta property="og:site_name" content="kyssion-blog">
<meta property="og:description" content="dubbo:service(dubbo:service)这个配置是针对服务端的，用来暴露服务端可以对外提供的服务信息  对应的配置类com.alibaba.dubbo.config.ServiceConfig     属性 对应URL 类型 是否必填 缺省值 作用 描述 兼容性     interface - class 必填 - 服务发现 服务接口名 1.0.0以上版本    ref - obj">
<meta property="og:locale" content="zh-Hans">
<meta property="og:updated_time" content="2018-10-09T07:22:37.333Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="kyssion-blog">
<meta name="twitter:description" content="dubbo:service(dubbo:service)这个配置是针对服务端的，用来暴露服务端可以对外提供的服务信息  对应的配置类com.alibaba.dubbo.config.ServiceConfig     属性 对应URL 类型 是否必填 缺省值 作用 描述 兼容性     interface - class 必填 - 服务发现 服务接口名 1.0.0以上版本    ref - obj">



<script type="text/javascript" id="hexo.configurations">
  var NexT = window.NexT || {};
  var CONFIG = {
    root: '/',
    scheme: 'Mist',
    version: '5.1.4',
    sidebar: {"position":"left","display":"post","offset":12,"b2t":false,"scrollpercent":false,"onmobile":false},
    fancybox: true,
    tabs: true,
    motion: {"enable":true,"async":false,"transition":{"post_block":"fadeIn","post_header":"slideDownIn","post_body":"slideDownIn","coll_header":"slideLeftIn","sidebar":"slideUpIn"}},
    duoshuo: {
      userId: '0',
      author: '博主'
    },
    algolia: {
      applicationID: '',
      apiKey: '',
      indexName: '',
      hits: {"per_page":10},
      labels: {"input_placeholder":"Search for Posts","hits_empty":"We didn't find any results for the search: ${query}","hits_stats":"${hits} results found in ${time} ms"}
    }
  };
</script>



  <link rel="canonical" href="http://yoursite.com/2018/10/09/dubbo学习和使用（八）dubbo配置参考/"/>





  <title> | kyssion-blog</title>
  








</head>

<body itemscope itemtype="http://schema.org/WebPage" lang="zh-Hans">

  
  
    
  

  <div class="container sidebar-position-left page-post-detail">
    <div class="headband"></div>

    <header id="header" class="header" itemscope itemtype="http://schema.org/WPHeader">
      <div class="header-inner"><div class="site-brand-wrapper">
  <div class="site-meta ">
    

    <div class="custom-logo-site-title">
      <a href="/"  class="brand" rel="start">
        <span class="logo-line-before"><i></i></span>
        <span class="site-title">kyssion-blog</span>
        <span class="logo-line-after"><i></i></span>
      </a>
    </div>
      
        <p class="site-subtitle"></p>
      
  </div>

  <div class="site-nav-toggle">
    <button>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
    </button>
  </div>
</div>

<nav class="site-nav">
  

  
    <ul id="menu" class="menu">
      
        
        <li class="menu-item menu-item-home">
          <a href="/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-home"></i> <br />
            
            首页
          </a>
        </li>
      
        
        <li class="menu-item menu-item-about">
          <a href="/about/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-user"></i> <br />
            
            关于
          </a>
        </li>
      
        
        <li class="menu-item menu-item-tags">
          <a href="/tags/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-tags"></i> <br />
            
            标签
          </a>
        </li>
      
        
        <li class="menu-item menu-item-categories">
          <a href="/categories/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-th"></i> <br />
            
            分类
          </a>
        </li>
      
        
        <li class="menu-item menu-item-archives">
          <a href="/archives/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-archive"></i> <br />
            
            归档
          </a>
        </li>
      
        
        <li class="menu-item menu-item-schedule">
          <a href="/schedule/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-calendar"></i> <br />
            
            日程表
          </a>
        </li>
      
        
        <li class="menu-item menu-item-sitemap">
          <a href="/sitemap.xml" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-sitemap"></i> <br />
            
            站点地图
          </a>
        </li>
      
        
        <li class="menu-item menu-item-commonweal">
          <a href="/404/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-heartbeat"></i> <br />
            
            公益404
          </a>
        </li>
      

      
    </ul>
  

  
</nav>



 </div>
    </header>

    <main id="main" class="main">
      <div class="main-inner">
        <div class="content-wrap">
          <div id="content" class="content">
            

  <div id="posts" class="posts-expand">
    

  

  
  
  

  <article class="post post-type-normal" itemscope itemtype="http://schema.org/Article">
  
  
  
  <div class="post-block">
    <link itemprop="mainEntityOfPage" href="http://yoursite.com/2018/10/09/dubbo学习和使用（八）dubbo配置参考/">

    <span hidden itemprop="author" itemscope itemtype="http://schema.org/Person">
      <meta itemprop="name" content="kyssion">
      <meta itemprop="description" content="">
      <meta itemprop="image" content="/images/avatar.gif">
    </span>

    <span hidden itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="kyssion-blog">
    </span>

    
      <header class="post-header">

        
        
          <h1 class="post-title" itemprop="name headline"></h1>
        

        <div class="post-meta">
          <span class="post-time">
            
              <span class="post-meta-item-icon">
                <i class="fa fa-calendar-o"></i>
              </span>
              
                <span class="post-meta-item-text">发表于</span>
              
              <time title="创建于" itemprop="dateCreated datePublished" datetime="2018-10-09T15:22:37+08:00">
                2018-10-09
              </time>
            

            

            
          </span>

          

          
            
          

          
          

          

          

          

        </div>
      </header>
    

    
    
    
    <div class="post-body" itemprop="articleBody">

      
      

      
        <h3 id="dubbo-service-dubbo-service"><a href="#dubbo-service-dubbo-service" class="headerlink" title="dubbo:service(dubbo:service)"></a>dubbo:service(<a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a>)</h3><p>这个配置是针对服务端的，用来暴露服务端可以对外提供的服务信息</p>
<blockquote>
<p>对应的配置类com.alibaba.dubbo.config.ServiceConfig</p>
</blockquote>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>interface</td>
<td>-</td>
<td>class</td>
<td>必填</td>
<td>-</td>
<td>服务发现</td>
<td>服务接口名</td>
<td>1.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>ref</td>
<td>-</td>
<td>object</td>
<td>必填</td>
<td>-</td>
<td>服务发现</td>
<td>服务对象实现引用</td>
<td>1.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>version</td>
<td>version</td>
<td>string</td>
<td>可选</td>
<td>0.0.0</td>
<td>服务发现</td>
<td>服务版本，建议使用两位数字版本，如：1.0，通常在接口不兼容是版本号才需要升级</td>
<td>1.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>group</td>
<td>group</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务发现</td>
<td>服务分组，当一个借口有多个实现，可以用分组区分</td>
<td>1.0.7以上版本</td>
<td></td>
</tr>
<tr>
<td>path</td>
<td></td>
<td>string</td>
<td>可选</td>
<td>缺省为接口</td>
<td>服务发现</td>
<td>服务路径</td>
<td>1.0.12以上版本</td>
<td></td>
</tr>
<tr>
<td>delay</td>
<td>delay</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>延迟注册服务时间(毫秒)，设为-1时，表示延迟到Spring容器初始化完成时暴露服务</td>
<td>1.0.14以上版本</td>
<td></td>
</tr>
<tr>
<td>timeout</td>
<td>timeout</td>
<td>int</td>
<td>可选</td>
<td>1000</td>
<td>性能调优</td>
<td>远程服务调用超时时间(毫秒)</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>retries</td>
<td>retries</td>
<td>int</td>
<td>可选</td>
<td>2</td>
<td>性能调优</td>
<td>远程服务调用重试次数，不包括第一次调用，0为不需要重试</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>connections</td>
<td>connections</td>
<td>boolean</td>
<td>可选</td>
<td>100</td>
<td>性能调优</td>
<td>对每个提供者的最大连接数，rmi、http、hesslan等多连接协议表示限制连接数，dubbo等长链接协议表示建立的长连接个数</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>loadbalance</td>
<td>loadbalance</td>
<td>string</td>
<td>可选</td>
<td>random</td>
<td>性能调优</td>
<td>负载均衡策略，可选值：random，roundrobin，leastactice，分别表示：随机，轮询，最少活跃调用</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>async</td>
<td>async</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>性能调优</td>
<td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>stub</td>
<td>stub</td>
<td>class/boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为ture，表示使用缺省代理类名，即：接口名+Local后缀，服务接口客户端本地代理类名，用于在客户端执行本地逻辑，如本地缓存等。该本地代理类的构造函数必须允许传入远程代理对象，构造函数如：publicxxxServiceLocal(XxxServicexxxService)</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>mock</td>
<td>mock</td>
<td>class/boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，表示使用缺省Mock类名，即：接口名+Mock后缀，服务接口调用失败Mock实现类，该Mock类必须有一个无参构造函数，与Local的区别在于，Local总是被执行，而Mock只在出现非业务异常(比如超时，网络异常等)时执行，Local在远程调用之前执行，Mock在远程调用后执行</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>token</td>
<td>token</td>
<td>string/bollean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>令牌验证，为空表示不开启。如果为true，表示随机生成动态令牌，否则使用静态令牌。令牌的作用是防止消费者绕过注册中心直接访问，保证注册中心的授权功能有效。如果使用点对点调用，需要关闭令牌功能</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>registry</td>
<td>-</td>
<td>string</td>
<td>可选</td>
<td>缺省向所有registry注册</td>
<td>配置关联</td>
<td>向指定注册中心注册<a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a>的属性为id的value；在向多个注册中心注册时，多个id使用逗号分隔；如果不想讲该服务注册到任何registry，可将值设置N/A</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>provider</td>
<td>-</td>
<td>string</td>
<td>可选</td>
<td>缺省使用第一个provider配置</td>
<td>配置关联</td>
<td>指定provider，值为<a href="dubbo:provider" target="_blank" rel="noopener">dubbo:provider</a>的id属性</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>deprecated</td>
<td>deprecated</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>服务是否过时，如果设置为true，消费方引用时将打印服务过时警告error日志</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>dynamic</td>
<td>dynamic</td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>服务治理</td>
<td>服务是否动态注册，如果设为false，注册后将显示disable状态，需要人工启用；并且服务提供者停止时，也不会自动取消注册，需要人工禁用</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>accesslog</td>
<td>accesslog</td>
<td>string/boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，将向logger中输入访问日志，也可以填写访问日志文件路径，直接把访问日志输出到指定文件</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>服务责任人，用于服务治理，请填写公司负责人邮箱前缀</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>document</td>
<td>document</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>服务文档URL</td>
<td>1.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>weight</td>
<td>weight</td>
<td>int</td>
<td>可选</td>
<td>-</td>
<td>服务调优</td>
<td>服务权重</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>executes</td>
<td>executes</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务提供者每个服务方法最大可并行请求数</td>
<td></td>
<td></td>
</tr>
<tr>
<td>actives</td>
<td>actives</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务消费者每个服务方法最大并发调用数</td>
<td></td>
<td></td>
</tr>
<tr>
<td>proxy</td>
<td>proxy</td>
<td>string</td>
<td>可选</td>
<td>javassist</td>
<td>性能调优</td>
<td>省城动态代理方法，可选：jdk/javassist</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>cluster</td>
<td>cluster</td>
<td>stirng</td>
<td>可选</td>
<td>failover</td>
<td>性能调优</td>
<td>集群方式，可选:failover/failfast/failsafe/failback/forking</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>filter</td>
<td>service.filter</td>
<td>string</td>
<td>可选</td>
<td>default</td>
<td>性能调优</td>
<td>服务提供方远程调用过程拦截器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>listener</td>
<td>exporter.listener</td>
<td>string</td>
<td>可选</td>
<td>default</td>
<td>性能调优</td>
<td>服务提供方导出服务监听器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>protocol</td>
<td>-</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>配置关联</td>
<td>使用指定的协议暴露服务，在使用多协议时，<a href="dubbo:protocol" target="_blank" rel="noopener">dubbo:protocol</a>的id属性的value,使用逗号分隔</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>layer</td>
<td>layer</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>服务提供者所在的分层。如：biz,dao,intl:web,china:acton</td>
<td>2.0.7以上版本</td>
<td></td>
</tr>
<tr>
<td>register</td>
<td>register</td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>服务治理</td>
<td>该协议的服务是否注册到注册中心</td>
<td>2.0.8以上版本</td>
<td></td>
</tr>
</tbody>
</table>
<p>注意：头四个是最重要的属性dubbo通过这些属性来唯一的标示一个service</p>
<h3 id="dubbo-reference"><a href="#dubbo-reference" class="headerlink" title="dubbo:reference"></a>dubbo:reference</h3><p>这个配置是针对消费者端的，消费中通过这个类发起请求向服务端进行调用</p>
<blockquote>
<p>对应的配置类com.alibaba.dubbo.config.ReferenceConfig</p>
</blockquote>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>-</td>
<td>string</td>
<td>必填</td>
<td>-</td>
<td>配置关联</td>
<td>服务应用beanid</td>
<td>1.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>interface</td>
<td>-</td>
<td>class</td>
<td>必填</td>
<td>-</td>
<td>服务发现</td>
<td>服务接口名</td>
<td>1.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>version</td>
<td>version</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务发现</td>
<td>服务版本，与服务提供者的版本保持一致</td>
<td>1.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>group</td>
<td>group</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务发现</td>
<td>服务分组，当一个借口有多个实现，可以用分组区分，必须和服务提供方一致</td>
<td>1.0.7版本</td>
<td></td>
</tr>
<tr>
<td>timeout</td>
<td>timeout</td>
<td>long</td>
<td>可选</td>
<td>缺省使用<a href="dubbo:consumer" target="_blank" rel="noopener">dubbo:consumer</a>的timeout</td>
<td>性能调优</td>
<td>服务方法调用超时时间(毫秒)</td>
<td>1.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>retries</td>
<td>retries</td>
<td>int</td>
<td>可选</td>
<td>缺省使用<a href="dubbo:consumer" target="_blank" rel="noopener">dubbo:consumer</a>的retries</td>
<td>性能调优</td>
<td>远程服务调用重试次数，不包括第一次调用，不需要重试请设置为0</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>connections</td>
<td>connections</td>
<td>int</td>
<td>可选</td>
<td>缺省使用的connections</td>
<td>性能调优</td>
<td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>loadbalance</td>
<td>loadbalance</td>
<td>string</td>
<td>可选</td>
<td>缺省使用的loadbalance</td>
<td>性能调优</td>
<td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>sync</td>
<td>sync</td>
<td>boolean</td>
<td>可选</td>
<td>缺省使用的async</td>
<td>性能调优</td>
<td>是否异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>generic</td>
<td>generic</td>
<td>boolean</td>
<td>可选</td>
<td>缺省使用的generic</td>
<td>服务治理</td>
<td>是否缺省泛化接口，如果为泛化接口，将返回GenericService</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>check</td>
<td>check</td>
<td>boolean</td>
<td>可选</td>
<td>缺省使用的check</td>
<td>服务治理</td>
<td>启动时检查提供者是否存在，true报错，false忽略</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>url</td>
<td><url></url></td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>点对点直连服务提供者地址，将绕过注册中心</td>
<td>1.0.6以上版本</td>
<td></td>
</tr>
<tr>
<td>stub</td>
<td>stub</td>
<td>class/boolean</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>服务接口客户端本地代理类名，用于在客户端执行本地逻辑，如本地缓存等，该本地代理类的构造函数必须允许传入远程代理对象，构造函数如：publicXxxServiceLocal(XxxServicexxxService)</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>mock</td>
<td>mock</td>
<td>class/boolean</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>服务接口调用失败Mock实现类名，该Mock类必须有一个无参构造函数，与Local的区别在于，Local总是被执行，而Mock只在出现非业务异常(比如超时，网络异常等)时执行，Local在远程调用之前执行，Mock在远程调用后执行</td>
<td>1.0.13以上版本</td>
<td></td>
</tr>
<tr>
<td>cache</td>
<td>cache</td>
<td>string/boolean</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>以调用参数为key，缓存返回结果。可选：lru,threadlocal,jcache等</td>
<td>2.1.0以上版本</td>
<td></td>
</tr>
<tr>
<td>validation</td>
<td>validation</td>
<td>boolean</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验</td>
<td>2.1.0以上版本</td>
<td></td>
</tr>
<tr>
<td>proxy</td>
<td>proxy</td>
<td>boolean</td>
<td>可选</td>
<td>javassist</td>
<td>性能调优</td>
<td>选择动态代理实现策略，可选：javassist,jdk</td>
<td>2.0.2以上版本</td>
<td></td>
</tr>
<tr>
<td>client</td>
<td>client</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>性能调优</td>
<td>客户端传输类型设置，如Dubbo协议的netty或mina</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>registry</td>
<td>-</td>
<td>string</td>
<td>可选</td>
<td>缺省将从所有注册中心获服务列表后合并结果</td>
<td>配置关联</td>
<td>从指定注册中心注册获取服务列表，在多个注册中心时使用，值为的id属性，多个注册中心ID用逗号分隔</td>
<td>2.0.0以上版本</td>
<td></td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>调用服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>actives</td>
<td>actives</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务消费者每个服务方法最大并发调用数</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>cluster</td>
<td>cluster</td>
<td>string</td>
<td>可选</td>
<td>failover</td>
<td>性能优化</td>
<td>集群方式，可选：failover/failfast/failsafe/failback/forking</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>filter</td>
<td>reference.filter</td>
<td>string</td>
<td>可选</td>
<td>default</td>
<td>性能调优</td>
<td>服务消费方远程调用过程拦截器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>listener</td>
<td>invoker.listener</td>
<td>string</td>
<td>可选</td>
<td>default</td>
<td>性能调优</td>
<td>服务消费方引用服务监听器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>layer</td>
<td>layer</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>服务调用者所在的分层。如：biz、dao、intl:web、china:acton</td>
<td>2.0.7以上版本</td>
<td></td>
</tr>
<tr>
<td>init</td>
<td>init</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>性能调优</td>
<td>是否在afterPropertiesSet()时饥饿初始化引用，否则等到有人注入或引用该实例时再初始化</td>
<td>2.0.10以上版本</td>
<td></td>
</tr>
<tr>
<td>protocol</td>
<td>protocol</td>
<td>string</td>
<td>可选</td>
<td>-</td>
<td>服务治理</td>
<td>只调用指定协议的服务提供方，其他协议忽略</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>注意：头四个是最重要的属性dubbo通过这些属性来唯一的标示一个service</p>
</blockquote>
<h3 id="dubbo-protocol-dubbo-protocol"><a href="#dubbo-protocol-dubbo-protocol" class="headerlink" title="dubbo:protocol(dubbo:protocol)"></a>dubbo:protocol(<a href="dubbo:protocol" target="_blank" rel="noopener">dubbo:protocol</a>)</h3><p>服务提供者协议配置。对应的配置类：com.alibaba.dubbo.config.ProtocolConfig。同时，如果需要支持多协议，可以声明多个<a href="dubbo:protocol" target="_blank" rel="noopener">dubbo:protocol</a>标签，并在<a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a>中通过protocol属性指定使用的协议。</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>配置关联</td>
<td>协议BeanId，可以在中引用此ID，如果ID不填，缺省和name属性值一样，重复则在name后加序号。</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>name</td>
<td>string</td>
<td>必填</td>
<td>dubbo</td>
<td>性能调优</td>
<td>协议名称</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>port</td>
<td>int</td>
<td>可选</td>
<td>dubbo协议缺省端口为20880，rmi协议缺省端口为1099，http和hessian协议缺省端口为80；如果没有配置port，则自动采用默认端口，如果配置为-1，则会分配一个没有被占用的端口。Dubbo2.4.0+，分配的端口在协议缺省端口的基础上增长，确保端口段可控。</td>
<td>服务发现</td>
<td>服务端口</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>host</td>
<td>string</td>
<td>可选</td>
<td>自动查找本机IP</td>
<td>服务发现</td>
<td>-服务主机名，多网卡选择或指定VIP及域名时使用，为空则自动查找本机IP，-建议不要配置，让Dubbo自动获取本机IP</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>threadpool</td>
<td>threadpool</td>
<td>string</td>
<td>可选</td>
<td>fixed</td>
<td>性能调优</td>
<td>线程池类型，可选：fixed/cached</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>threads</td>
<td>threads</td>
<td>int</td>
<td>可选</td>
<td>200</td>
<td>性能调优</td>
<td>服务线程池大小(固定大小)</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>iothreads</td>
<td>threads</td>
<td>int</td>
<td>可选</td>
<td>cpu个数+1</td>
<td>性能调优</td>
<td>io线程池大小(固定大小)</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>accepts</td>
<td>accepts</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务提供方最大可接受连接数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>payload</td>
<td>payload</td>
<td>int</td>
<td>可选</td>
<td>8388608(=8M)</td>
<td>性能调优</td>
<td>请求及响应数据包大小限制，单位：字节</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>codec</td>
<td>codec</td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>性能调优</td>
<td>协议编码方式</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>serialization</td>
<td>serialization</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为hessian2，rmi协议缺省为java，http协议缺省为json</td>
<td>性能调优</td>
<td>协议序列化方式，当协议支持多种序列化方式时使用，比如：dubbo协议的dubbo,hessian2,java,compactedjava，以及http协议的json等</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>accesslog</td>
<td>accesslog</td>
<td>string/boolean</td>
<td>可选</td>
<td>服务治理</td>
<td>设为true，将向logger中输出访问日志，也可填写访问日志文件路径，直接把访问日志输出到指定文件</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>path</td>
<td>string</td>
<td>可选</td>
<td>服务发现</td>
<td>提供者上下文路径，为服务path的前缀</td>
<td>2.0.5以上版本</td>
<td></td>
<td></td>
</tr>
<tr>
<td>transporter</td>
<td>transporter</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为netty</td>
<td>性能调优</td>
<td>协议的服务端和客户端实现类型，比如：dubbo协议的mina,netty等，可以分拆为server和client配置</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>server</td>
<td>server</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为netty，http协议缺省为servlet</td>
<td>性能调优</td>
<td>协议的服务器端实现类型，比如：dubbo协议的mina,netty等，http协议的jetty,servlet等</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>client</td>
<td>client</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为netty</td>
<td>性能调优</td>
<td>协议的客户端实现类型，比如：dubbo协议的mina,netty等</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>dispatcher</td>
<td>dispatcher</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为all</td>
<td>性能调优</td>
<td>协议的消息派发方式，用于指定线程模型，比如：dubbo协议的all,direct,message,execution,connection等</td>
<td>2.1.0以上版本</td>
</tr>
<tr>
<td>queues</td>
<td>queues</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>线程池队列大小，当线程池满时，排队等待执行的队列大小，建议不要设置，当线程程池时应立即失败，重试其它服务提供机器，而不是排队，除非有特殊需求。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>charset</td>
<td>charset</td>
<td>string</td>
<td>可选</td>
<td>UTF-8</td>
<td>性能调优</td>
<td>序列化编码</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>buffer</td>
<td>buffer</td>
<td>int</td>
<td>可选</td>
<td>8192</td>
<td>性能调优</td>
<td>网络读写缓冲区大小</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>heartbeat</td>
<td>heartbeat</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>心跳间隔，对于长连接，当物理层断开时，比如拔网线，TCP的FIN消息来不及发送，对方收不到断开事件，此时需要心跳来帮助检查连接是否已断开</td>
<td>2.0.10以上版本</td>
</tr>
<tr>
<td>telnet</td>
<td>telnet</td>
<td>string</td>
<td>可选</td>
<td>服务治理</td>
<td>所支持的telnet命令，多个命令用逗号分隔</td>
<td>2.0.5以上版本</td>
<td></td>
</tr>
<tr>
<td>register</td>
<td>register</td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>服务治理</td>
<td>该协议的服务是否注册到注册中心</td>
<td>2.0.8以上版本</td>
</tr>
<tr>
<td>contextpath</td>
<td>contextpath</td>
<td>String</td>
<td>可选</td>
<td>缺省为空串</td>
<td>服务治理</td>
<td>2.0.6以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-registry-dubbo-registry"><a href="#dubbo-registry-dubbo-registry" class="headerlink" title="dubbo:registry(dubbo:registry)"></a>dubbo:registry(<a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a>)</h3><p>注册中心配置。对应的配置类： com.alibaba.dubbo.config.RegistryConfig。同时如果有多个不同的注册中心，可以声明多个 <a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a> 标签，并在 <a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a> 或 <a href="dubbo:reference" target="_blank" rel="noopener">dubbo:reference</a> 的 registry 属性指定使用的注册中心。</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td></td>
<td>string</td>
<td>可选</td>
<td></td>
<td>配置关联</td>
<td>注册中心引用BeanId，可以在<a href="dubbo:serviceregistry=&quot;&quot;" target="_blank" rel="noopener">dubbo:serviceregistry=&quot;&quot;</a>或<a href="dubbo:referenceregistry=&quot;&quot;" target="_blank" rel="noopener">dubbo:referenceregistry=&quot;&quot;</a>中引用此ID</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>address</td>
<td><a href="host:port" target="_blank" rel="noopener">host:port</a></td>
<td>string</td>
<td>必填</td>
<td></td>
<td>服务发现</td>
<td>注册中心服务器地址，如果地址没有端口缺省为9090，同一集群内的多个地址用逗号分隔，如：ip:port,ip:port，不同集群的注册中心，请配置多个<a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a>标签</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>protocol</td>
<td><protocol></protocol></td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>服务发现</td>
<td>注同中心地址协议，支持dubbo,http,local三种协议，分别表示，dubbo地址，http地址，本地注册中心</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>port</td>
<td><port></port></td>
<td>int</td>
<td>可选</td>
<td>9090</td>
<td>服务发现</td>
<td>注册中心缺省端口，当address没有带端口时使用此端口做为缺省值</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>username</td>
<td><username></username></td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>登录注册中心用户名，如果注册中心不需要验证可不填</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>password</td>
<td><password></password></td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>登录注册中心密码，如果注册中心不需要验证可不填</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>transport</td>
<td>registry.transporter</td>
<td>string</td>
<td>可选</td>
<td>netty</td>
<td>性能调优</td>
<td>网络传输方式，可选mina,netty</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>timeout</td>
<td>registry.timeout</td>
<td>int</td>
<td>可选</td>
<td>5000</td>
<td>性能调优</td>
<td>注册中心请求超时时间(毫秒)</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>session</td>
<td>registry.session</td>
<td>int</td>
<td>可选</td>
<td>60000</td>
<td>性能调优</td>
<td>注册中心会话超时时间(毫秒)，用于检测提供者非正常断线后的脏数据，比如用心跳检测的实现，此时间就是心跳间隔，不同注册中心实现不一样。</td>
<td>2.1.0以上版本</td>
</tr>
<tr>
<td>file</td>
<td>registry.file</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>使用文件缓存注册中心地址列表及服务提供者列表，应用重启时将基于此文件恢复，注意：两个注册中心不能使用同一文件存储</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>wait</td>
<td>registry.wait</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>停止时等待通知完成时间(毫秒)</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>check</td>
<td>check</td>
<td>boolean</td>
<td>可选</td>
<td>true</td>
<td>服务治理</td>
<td>注册中心不存在时，是否报错</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>register</td>
<td>register</td>
<td>boolean</td>
<td>可选</td>
<td>true</td>
<td>服务治理</td>
<td>是否向此注册中心注册服务，如果设为false，将只订阅，不注册</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>subscribe</td>
<td>subscribe</td>
<td>boolean</td>
<td>可选</td>
<td>true</td>
<td>服务治理</td>
<td>是否向此注册中心订阅服务，如果设为false，将只注册，不订阅</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>dynamic</td>
<td>dynamic</td>
<td>boolean</td>
<td>可选</td>
<td>true</td>
<td>服务治理</td>
<td>服务是否动态注册，如果设为false，注册后将显示后disable状态，需人工启用，并且服务提供者停止时，也不会自动取消册，需人工禁用。</td>
<td>2.0.5以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-monitor"><a href="#dubbo-monitor" class="headerlink" title="dubbo:monitor"></a>dubbo:monitor</h3><p>监控中心配置。对应的配置类： com.alibaba.dubbo.config.MonitorConfig</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>protocol</td>
<td>protocol</td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>服务治理</td>
<td>监控中心协议，如果为protocol=”registry”，表示从注册中心发现监控中心地址，否则直连监控中心。</td>
<td>2.0.9以上版本</td>
</tr>
<tr>
<td>address</td>
<td><url></url></td>
<td>string</td>
<td>可选</td>
<td>N/A</td>
<td>服务治理</td>
<td>直连监控中心服务器地址，address=”10.20.130.230:12080”</td>
<td>1.0.16以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-applicationdubbo-application"><a href="#dubbo-applicationdubbo-application" class="headerlink" title="dubbo:applicationdubbo:application"></a>dubbo:application<a href="dubbo:application" target="_blank" rel="noopener">dubbo:application</a></h3><p>应用信息配置。对应的配置类：com.alibaba.dubbo.config.ApplicationConfig</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>application</td>
<td>string</td>
<td>必填</td>
<td></td>
<td>服务治理</td>
<td>当前应用名称，用于注册中心计算应用间依赖关系，注意：消费者和提供者应用名不要一样，此参数不是匹配条件，你当前项目叫什么名字就填什么，和提供者消费者角色无关，比如：kylin应用调用了morgan应用的服务，则kylin项目配成kylin，morgan项目配成morgan，可能kylin也提供其它服务给别人使用，但kylin项目永远配成kylin，这样注册中心将显示kylin依赖于morgan</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>version</td>
<td>application.version</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>当前应用的版本</td>
<td>2.2.0以上版本</td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>应用负责人，用于服务治理，请填写负责人公司邮箱前缀</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>organization</td>
<td>organization</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>组织名称(BU或部门)，用于注册中心区分服务来源，此配置项建议不要使用autoconfig，直接写死在配置中，比如china,intl,itu,crm,asc,dw,aliexpress等</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>architecture</td>
<td>architecture</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>用于服务分层对应的架构。如，intl、china。不同的架构使用不同的分层。</td>
<td>2.0.7以上版本</td>
</tr>
<tr>
<td>environment</td>
<td>environment</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>应用环境，如：develop/test/product，不同环境使用不同的缺省值，以及作为只用于开发测试功能的限制条件</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>compiler</td>
<td>compiler</td>
<td>string</td>
<td>可选</td>
<td>javassist</td>
<td>性能优化</td>
<td>Java字节码编译器，用于动态类的生成，可选：jdk或javassist</td>
<td>2.1.0以上版本</td>
</tr>
<tr>
<td>logger</td>
<td>logger</td>
<td>string</td>
<td>可选</td>
<td>slf4j</td>
<td>性能优化</td>
<td>日志输出方式，可选：slf4j,jcl,log4j,jdk</td>
<td>2.2.0以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-moduledubbo-module"><a href="#dubbo-moduledubbo-module" class="headerlink" title="dubbo:moduledubbo:module"></a>dubbo:module<a href="dubbo:module" target="_blank" rel="noopener">dubbo:module</a></h3><p>模块信息配置。对应的配置类 com.alibaba.dubbo.config.ModuleConfig</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>module</td>
<td>string</td>
<td>必填</td>
<td></td>
<td>服务治理</td>
<td>当前模块名称，用于注册中心计算模块间依赖关系</td>
<td>2.2.0以上版本</td>
</tr>
<tr>
<td>version</td>
<td>module.version</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>当前模块的版本</td>
<td>2.2.0以上版本</td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>模块负责人，用于服务治理，请填写负责人公司邮箱前缀</td>
<td>2.2.0以上版本</td>
</tr>
<tr>
<td>organization</td>
<td>organization</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>组织名称(BU或部门)，用于注册中心区分服务来源，此配置项建议不要使用autoconfig，直接写死在配置中，比如china,intl,itu,crm,asc,dw,aliexpress等</td>
<td>2.2.0以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-provider-lt-dubbo：provider-gt"><a href="#dubbo-provider-lt-dubbo：provider-gt" class="headerlink" title="dubbo:provider(&lt;dubbo：provider&gt;)"></a>dubbo:provider(&lt;dubbo：provider&gt;)</h3><p>服务提供者缺省值配置。对应的配置类： com.alibaba.dubbo.config.ProviderConfig。同时该标签为 <a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a> 和 <a href="dubbo:protocol" target="_blank" rel="noopener">dubbo:protocol</a> 标签的缺省值设置。（就是service和service对应的protocol的默认配置）</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td></td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>配置关联</td>
<td>协议BeanId，可以在<a href="dubbo:serviceproivder=&quot;&quot;" target="_blank" rel="noopener">dubbo:serviceproivder=&quot;&quot;</a>中引用此ID</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>protocol</td>
<td><protocol></protocol></td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>性能调优</td>
<td>协议名称</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>host</td>
<td><host></host></td>
<td>string</td>
<td>可选</td>
<td>自动查找本机IP</td>
<td>服务发现</td>
<td>服务主机名，多网卡选择或指定VIP及域名时使用，为空则自动查找本机IP，建议不要配置，让Dubbo自动获取本机IP</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>threads</td>
<td>threads</td>
<td>int</td>
<td>可选</td>
<td>200</td>
<td>性能调优</td>
<td>服务线程池大小(固定大小)</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>payload</td>
<td>payload</td>
<td>int</td>
<td>可选</td>
<td>8388608(=8M)</td>
<td>性能调优</td>
<td>请求及响应数据包大小限制，单位：字节</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>path</td>
<td><path></path></td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务发现</td>
<td>提供者上下文路径，为服务path的前缀</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>server</td>
<td>server</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为netty，http协议缺省为servlet</td>
<td>性能调优</td>
<td>协议的服务器端实现类型，比如：dubbo协议的mina,netty等，http协议的jetty,servlet等</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>client</td>
<td>client</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为netty</td>
<td>性能调优</td>
<td>协议的客户端实现类型，比如：dubbo协议的mina,netty等</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>codec</td>
<td>codec</td>
<td>string</td>
<td>可选</td>
<td>dubbo</td>
<td>性能调优</td>
<td>协议编码方式</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>serialization</td>
<td>serialization</td>
<td>string</td>
<td>可选</td>
<td>dubbo协议缺省为hessian2，rmi协议缺省为java，http协议缺省为json</td>
<td>性能调优</td>
<td>协议序列化方式，当协议支持多种序列化方式时使用，比如：dubbo协议的dubbo,hessian2,java,compactedjava，以及http协议的json,xml等</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>default</td>
<td></td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>配置关联</td>
<td>是否为缺省协议，用于多协议</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>filter</td>
<td>service.filter</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>服务提供方远程调用过程拦截器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>listener</td>
<td>exporter.listener</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>服务提供方导出服务监听器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>threadpool</td>
<td>threadpool</td>
<td>string</td>
<td>可选</td>
<td>fixed</td>
<td>性能调优</td>
<td>线程池类型，可选：fixed/cached</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>accepts</td>
<td>accepts</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务提供者最大可接受连接数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>version</td>
<td>version</td>
<td>string</td>
<td>可选</td>
<td>0.0.0</td>
<td>服务发现</td>
<td>服务版本，建议使用两位数字版本，如：1.0，通常在接口不兼容时版本号才需要升级</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>group</td>
<td>group</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务发现</td>
<td>服务分组，当一个接口有多个实现，可以用分组区分</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>delay</td>
<td>delay</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>延迟注册服务时间(毫秒)，设为1时，表示延迟到Spring容器初始化完成时暴露服务</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>timeout</td>
<td>default.timeout</td>
<td>int</td>
<td>可选</td>
<td>1000</td>
<td>性能调优</td>
<td>远程服务调用超时时间(毫秒)</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>retries</td>
<td>default.retries</td>
<td>int</td>
<td>可选</td>
<td>2</td>
<td>性能调优</td>
<td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>connections</td>
<td>default.connections</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>loadbalance</td>
<td>default.loadbalance</td>
<td>string</td>
<td>可选</td>
<td>random</td>
<td>性能调优</td>
<td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>async</td>
<td>default.async</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>性能调优</td>
<td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>stub</td>
<td>stub</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，表示使用缺省代理类名，即：接口名+Local后缀。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>mock</td>
<td>mock</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，表示使用缺省Mock类名，即：接口名+Mock后缀。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>token</td>
<td>token</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>令牌验证，为空表示不开启，如果为true，表示随机生成动态令牌</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>registry</td>
<td>registry</td>
<td>string</td>
<td>可选</td>
<td>缺省向所有registry注册</td>
<td>配置关联</td>
<td>向指定注册中心注册，在多个注册中心时使用，值为<a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a>的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>dynamic</td>
<td>dynamic</td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>服务治理</td>
<td>服务是否动态注册，如果设为false，注册后将显示后disable状态，需人工启用，并且服务提供者停止时，也不会自动取消册，需人工禁用。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>accesslog</td>
<td>accesslog</td>
<td>string/boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，将向logger中输出访问日志，也可填写访问日志文件路径，直接把访问日志输出到指定文件</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>document</td>
<td>document</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务文档URL</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>weight</td>
<td>weight</td>
<td>int</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>服务权重</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>executes</td>
<td>executes</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务提供者每服务每方法最大可并行执行请求数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>actives</td>
<td>default.actives</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>每服务消费者每服务每方法最大并发调用数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>proxy</td>
<td>proxy</td>
<td>string</td>
<td>可选</td>
<td>javassist</td>
<td>性能调优</td>
<td>生成动态代理方式，可选：jdk/javassist</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>cluster</td>
<td>default.cluster</td>
<td>string</td>
<td>可选</td>
<td>failover</td>
<td>性能调优</td>
<td>集群方式，可选：failover/failfast/failsafe/failback/forking</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>deprecated</td>
<td>deprecated</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>服务是否过时，如果设为true，消费方引用时将打印服务过时警告error日志</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>queues</td>
<td>queues</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>线程池队列大小，当线程池满时，排队等待执行的队列大小，建议不要设置，当线程程池时应立即失败，重试其它服务提供机器，而不是排队，除非有特殊需求。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>charset</td>
<td>charset</td>
<td>string</td>
<td>可选</td>
<td>UTF8</td>
<td>性能调优</td>
<td>序列化编码</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>buffer</td>
<td>buffer</td>
<td>int</td>
<td>可选</td>
<td>8192</td>
<td>性能调优</td>
<td>网络读写缓冲区大小</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>iothreads</td>
<td>iothreads</td>
<td>int</td>
<td>可选</td>
<td>CPU+1</td>
<td>性能调优</td>
<td>IO线程池，接收网络读写中断，以及序列化和反序列化，不处理业务，业务线程池参见threads配置，此线程池和CPU相关，不建议配置。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>telnet</td>
<td>telnet</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>所支持的telnet命令，多个命令用逗号分隔</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td><a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a></td>
<td>contextpath</td>
<td>contextpath</td>
<td>String</td>
<td>可选</td>
<td>缺省为空串</td>
<td>服务治理</td>
<td></td>
</tr>
<tr>
<td>layer</td>
<td>layer</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务提供者所在的分层。如：biz、dao、intl:web、china:acton。</td>
<td>2.0.7以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-consumer-dubbo-consumer"><a href="#dubbo-consumer-dubbo-consumer" class="headerlink" title="dubbo:consumer(dubbo:consumer)"></a>dubbo:consumer(<a href="dubbo:consumer" target="_blank" rel="noopener">dubbo:consumer</a>)</h3><p>服务消费者缺省值配置。配置类： com.alibaba.dubbo.config.ConsumerConfig 。同时该标签为 <a href="dubbo:reference" target="_blank" rel="noopener">dubbo:reference</a> 标签的缺省值设置。</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>timeout</td>
<td>default.timeout</td>
<td>int</td>
<td>可选</td>
<td>1000</td>
<td>性能调优</td>
<td>远程服务调用超时时间(毫秒)</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>retries</td>
<td>default.retries</td>
<td>int</td>
<td>可选</td>
<td>2</td>
<td>性能调优</td>
<td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>loadbalance</td>
<td>default.loadbalance</td>
<td>string</td>
<td>可选</td>
<td>random</td>
<td>性能调优</td>
<td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>async</td>
<td>default.async</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>性能调优</td>
<td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>connections</td>
<td>default.connections</td>
<td>int</td>
<td>可选</td>
<td>100</td>
<td>性能调优</td>
<td>每个服务对每个提供者的最大连接数，rmi、http、hessian等短连接协议支持此配置，dubbo协议长连接不支持此配置</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>generic</td>
<td>generic</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>是否缺省泛化接口，如果为泛化接口，将返回GenericService</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>check</td>
<td>check</td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>服务治理</td>
<td>启动时检查提供者是否存在，true报错，false忽略</td>
<td>1.0.16以上版本</td>
</tr>
<tr>
<td>proxy</td>
<td>proxy</td>
<td>string</td>
<td>可选</td>
<td>javassist</td>
<td>性能调优</td>
<td>生成动态代理方式，可选：jdk/javassist</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>调用服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>actives</td>
<td>default.actives</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>每服务消费者每服务每方法最大并发调用数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>cluster</td>
<td>default.cluster</td>
<td>string</td>
<td>可选</td>
<td>failover</td>
<td>性能调优</td>
<td>集群方式，可选：failover/failfast/failsafe/failback/forking</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>filter</td>
<td>reference.filter</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>服务消费方远程调用过程拦截器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>listener</td>
<td>invoker.listener</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>服务消费方引用服务监听器名称，多个名称用逗号分隔</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>registry</td>
<td></td>
<td>string</td>
<td>可选</td>
<td>缺省向所有registry注册</td>
<td>配置关联</td>
<td>向指定注册中心注册，在多个注册中心时使用，值为<a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a>的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>layer</td>
<td>layer</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务调用者所在的分层。如：biz、dao、intl:web、china:acton。</td>
<td>2.0.7以上版本</td>
</tr>
<tr>
<td>init</td>
<td>init</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>性能调优</td>
<td>是否在afterPropertiesSet()时饥饿初始化引用，否则等到有人注入或引用该实例时再初始化。</td>
<td>2.0.10以上版本</td>
</tr>
<tr>
<td>cache</td>
<td>cache</td>
<td>string/boolean</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>以调用参数为key，缓存返回结果，可选：lru,threadlocal,jcache等</td>
<td>Dubbo2.1.0及其以上版本支持</td>
</tr>
<tr>
<td>validation</td>
<td>validation</td>
<td>boolean</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验</td>
<td>Dubbo2.1.0及其以上版本支持</td>
</tr>
<tr>
<td>timeout</td>
<td>default.timeout</td>
<td>int</td>
<td>可选</td>
<td>1000</td>
<td>性能调优</td>
<td>远程服务调用超时时间(毫秒)</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>retries</td>
<td>default.retries</td>
<td>int</td>
<td>可选</td>
<td>2</td>
<td>性能调优</td>
<td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>connections</td>
<td>default.connections</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>loadbalance</td>
<td>default.loadbalance</td>
<td>string</td>
<td>可选</td>
<td>random</td>
<td>性能调优</td>
<td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>async</td>
<td>default.async</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>性能调优</td>
<td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>stub</td>
<td>stub</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，表示使用缺省代理类名，即：接口名+Local后缀。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>mock</td>
<td>mock</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，表示使用缺省Mock类名，即：接口名+Mock后缀。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>token</td>
<td>token</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>令牌验证，为空表示不开启，如果为true，表示随机生成动态令牌</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>registry</td>
<td>registry</td>
<td>string</td>
<td>可选</td>
<td>缺省向所有registry注册</td>
<td>配置关联</td>
<td>向指定注册中心注册，在多个注册中心时使用，值为<a href="dubbo:registry" target="_blank" rel="noopener">dubbo:registry</a>的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>dynamic</td>
<td>dynamic</td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>服务治理</td>
<td>服务是否动态注册，如果设为false，注册后将显示后disable状态，需人工启用，并且服务提供者停止时，也不会自动取消册，需人工禁用。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>accesslog</td>
<td>accesslog</td>
<td>string/boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设为true，将向logger中输出访问日志，也可填写访问日志文件路径，直接把访问日志输出到指定文件</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>owner</td>
<td>owner</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>document</td>
<td>document</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务文档URL</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>weight</td>
<td>weight</td>
<td>int</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>服务权重</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>executes</td>
<td>executes</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>服务提供者每服务每方法最大可并行执行请求数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>actives</td>
<td>default.actives</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>每服务消费者每服务每方法最大并发调用数</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>proxy</td>
<td>proxy</td>
<td>string</td>
<td>可选</td>
<td>javassist</td>
<td>性能调优</td>
<td>生成动态代理方式，可选：jdk/javassist</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>cluster</td>
<td>default.cluster</td>
<td>string</td>
<td>可选</td>
<td>failover</td>
<td>性能调优</td>
<td>集群方式，可选：failover/failfast/failsafe/failback/forking</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>deprecated</td>
<td>deprecated</td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>服务是否过时，如果设为true，消费方引用时将打印服务过时警告error日志</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>queues</td>
<td>queues</td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>线程池队列大小，当线程池满时，排队等待执行的队列大小，建议不要设置，当线程程池时应立即失败，重试其它服务提供机器，而不是排队，除非有特殊需求。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>charset</td>
<td>charset</td>
<td>string</td>
<td>可选</td>
<td>UTF8</td>
<td>性能调优</td>
<td>序列化编码</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>buffer</td>
<td>buffer</td>
<td>int</td>
<td>可选</td>
<td>8192</td>
<td>性能调优</td>
<td>网络读写缓冲区大小</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>iothreads</td>
<td>iothreads</td>
<td>int</td>
<td>可选</td>
<td>CPU+1</td>
<td>性能调优</td>
<td>IO线程池，接收网络读写中断，以及序列化和反序列化，不处理业务，业务线程池参见threads配置，此线程池和CPU相关，不建议配置。</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>telnet</td>
<td>telnet</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>所支持的telnet命令，多个命令用逗号分隔</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td><a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a></td>
<td>contextpath</td>
<td>contextpath</td>
<td>String</td>
<td>可选</td>
<td>缺省为空串</td>
<td>服务治理</td>
<td></td>
</tr>
<tr>
<td>layer</td>
<td>layer</td>
<td>string</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>服务提供者所在的分层。如：biz、dao、intl:web、china:acton。</td>
<td>2.0.7以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-method-dubbo-method"><a href="#dubbo-method-dubbo-method" class="headerlink" title="dubbo:method (dubbo:method)"></a>dubbo:method (<a href="dubbo:method" target="_blank" rel="noopener">dubbo:method</a>)</h3><p>方法级配置。对应的配置类： com.alibaba.dubbo.config.MethodConfig。同时该标签为 <a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a> 或 <a href="dubbo:reference" target="_blank" rel="noopener">dubbo:reference</a> 的子标签，用于控制到方法级。</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td></td>
<td>string</td>
<td>必填</td>
<td></td>
<td>标识</td>
<td>方法名</td>
<td>1.0.8以上版本</td>
</tr>
<tr>
<td>timeout</td>
<td><metodname>.timeout</metodname></td>
<td>int</td>
<td>可选</td>
<td>缺省为的timeout</td>
<td>性能调优</td>
<td>方法调用超时时间(毫秒)</td>
<td>1.0.8以上版本</td>
</tr>
<tr>
<td>retries</td>
<td><metodname>.retries</metodname></td>
<td>int</td>
<td>可选</td>
<td>缺省为<a href="dubbo:reference" target="_blank" rel="noopener">dubbo:reference</a>的retries</td>
<td>性能调优</td>
<td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>loadbalance</td>
<td><metodname>.loadbalance</metodname></td>
<td>string</td>
<td>可选</td>
<td>缺省为的loadbalance</td>
<td>性能调优</td>
<td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>async</td>
<td><metodname>.async</metodname></td>
<td>boolean</td>
<td>可选</td>
<td>缺省为<a href="dubbo:reference" target="_blank" rel="noopener">dubbo:reference</a>的async</td>
<td>性能调优</td>
<td>是否异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td>
<td>1.0.9以上版本</td>
</tr>
<tr>
<td>sent</td>
<td><methodname>.sent</methodname></td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>性能调优</td>
<td>异步调用时，标记sent=true时，表示网络已发出数据</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>actives</td>
<td><metodname>.actives</metodname></td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>每服务消费者最大并发调用限制</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>executes</td>
<td><metodname>.executes</metodname></td>
<td>int</td>
<td>可选</td>
<td>0</td>
<td>性能调优</td>
<td>每服务每方法最大使用线程数限制，此属性只在<a href="dubbo:method" target="_blank" rel="noopener">dubbo:method</a>作为<a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a>子标签时有效</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>deprecated</td>
<td><methodname>.deprecated</methodname></td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>服务方法是否过时，此属性只在<a href="dubbo:method" target="_blank" rel="noopener">dubbo:method</a>作为<a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a>子标签时有效</td>
<td>2.0.5以上版本</td>
</tr>
<tr>
<td>sticky</td>
<td><methodname>.sticky</methodname></td>
<td>boolean</td>
<td>可选</td>
<td>FALSE</td>
<td>服务治理</td>
<td>设置true该接口上的所有方法使用同一个provider.如果需要更复杂的规则，请使用用路由</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>return</td>
<td><methodname>.return</methodname></td>
<td>boolean</td>
<td>可选</td>
<td>TRUE</td>
<td>性能调优</td>
<td>方法调用是否需要返回值,async设置为true时才生效，如果设置为true，则返回future，或回调onreturn等方法，如果设置为false，则请求发送成功后直接返回Null</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>oninvoke</td>
<td>attribute属性，不在URL中体现</td>
<td>String</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>方法执行前拦截</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>onreturn</td>
<td>attribute属性，不在URL中体现</td>
<td>String</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>方法执行返回后拦截</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>onthrow</td>
<td>attribute属性，不在URL中体现</td>
<td>String</td>
<td>可选</td>
<td></td>
<td>性能调优</td>
<td>方法执行有异常拦截</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>cache</td>
<td><methodname>.cache</methodname></td>
<td>string/boolean</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>以调用参数为key，缓存返回结果，可选：lru,threadlocal,jcache等</td>
<td>Dubbo2.1.0及其以上版本支持</td>
</tr>
<tr>
<td>validation</td>
<td><methodname>.validation</methodname></td>
<td>boolean</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验</td>
<td>Dubbo2.1.0及其以上版本支持</td>
</tr>
</tbody>
</table>
<blockquote>
<p>代码实例</p>
</blockquote>
<figure class="highlight xml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">dubbo:reference</span> <span class="attr">interface</span>=<span class="string">"com.xxx.XxxService"</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">dubbo:method</span> <span class="attr">name</span>=<span class="string">"findXxx"</span> <span class="attr">timeout</span>=<span class="string">"3000"</span> <span class="attr">retries</span>=<span class="string">"2"</span> /&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">dubbo:reference</span>&gt;</span></span><br></pre></td></tr></table></figure>
<h3 id="dubbo-argument-dubbo-argument"><a href="#dubbo-argument-dubbo-argument" class="headerlink" title="dubbo:argument(dubbo:argument)"></a>dubbo:argument(<a href="dubbo:argument" target="_blank" rel="noopener">dubbo:argument</a>)</h3><p>方法参数配置。对应的配置类： com.alibaba.dubbo.config.ArgumentConfig。该标签为 <a href="dubbo:method" target="_blank" rel="noopener">dubbo:method</a> 的子标签，用于方法参数的特征描述，比如：</p>
<figure class="highlight xml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">dubbo:method</span> <span class="attr">name</span>=<span class="string">"findXxx"</span> <span class="attr">timeout</span>=<span class="string">"3000"</span> <span class="attr">retries</span>=<span class="string">"2"</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">dubbo:argument</span> <span class="attr">index</span>=<span class="string">"0"</span> <span class="attr">callback</span>=<span class="string">"true"</span> /&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">dubbo:method</span>&gt;</span></span><br></pre></td></tr></table></figure>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>index</td>
<td></td>
<td>int</td>
<td>必填</td>
<td></td>
<td>标识</td>
<td>方法名</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>type</td>
<td></td>
<td>String</td>
<td>与index二选一</td>
<td></td>
<td>标识</td>
<td>通过参数类型查找参数的index</td>
<td>2.0.6以上版本</td>
</tr>
<tr>
<td>callback</td>
<td><metodname><index>.retries</index></metodname></td>
<td>boolean</td>
<td>可选</td>
<td></td>
<td>服务治理</td>
<td>参数是否为callback接口，如果为callback，服务提供方将生成反向代理，可以从服务提供方反向调用消费方，通常用于事件推送.</td>
<td>2.0.6以上版本</td>
</tr>
</tbody>
</table>
<h3 id="dubbo-parameter"><a href="#dubbo-parameter" class="headerlink" title="dubbo:parameter()"></a>dubbo:parameter(<dubbo>)</dubbo></h3><p>选项参数配置。对应的配置类：java.util.Map。同时该标签为<a href="dubbo:protocol" target="_blank" rel="noopener">dubbo:protocol</a>或<a href="dubbo:service" target="_blank" rel="noopener">dubbo:service</a>或<a href="dubbo:provider" target="_blank" rel="noopener">dubbo:provider</a>或<a href="dubbo:reference" target="_blank" rel="noopener">dubbo:reference</a>或<a href="dubbo:consumer" target="_blank" rel="noopener">dubbo:consumer</a>的子标签，用于配置自定义参数，该配置项将作为扩展点设置自定义参数使用。</p>
<table>
<thead>
<tr>
<th>属性</th>
<th>对应URL参数</th>
<th>类型</th>
<th>是否必填</th>
<th>缺省值</th>
<th>作用</th>
<th>描述</th>
<th>兼容性</th>
</tr>
</thead>
<tbody>
<tr>
<td>key</td>
<td>key</td>
<td>string</td>
<td>必填</td>
<td></td>
<td>服务治理</td>
<td>路由参数键</td>
<td>2.0.0以上版本</td>
</tr>
<tr>
<td>value</td>
<td>value</td>
<td>string</td>
<td>必填</td>
<td></td>
<td>服务治理</td>
<td>路由参数值</td>
<td>2.0.0以上版本</td>
</tr>
</tbody>
</table>
<figure class="highlight xml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">dubbo:protocol</span> <span class="attr">name</span>=<span class="string">"napoli"</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">dubbo:parameter</span> <span class="attr">key</span>=<span class="string">"http://10.20.160.198/wiki/display/dubbo/napoli.queue.name"</span> <span class="attr">value</span>=<span class="string">"xxx"</span> /&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">dubbo:protocol</span>&gt;</span></span><br></pre></td></tr></table></figure>
<figure class="highlight xml"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">dubbo:protocol</span> <span class="attr">name</span>=<span class="string">"jms"</span> <span class="attr">p:queue</span>=<span class="string">"xxx"</span> /&gt;</span></span><br></pre></td></tr></table></figure>
      
    </div>
    
    
    

    

    

    

    <footer class="post-footer">
      

      
      
      

      
        <div class="post-nav">
          <div class="post-nav-next post-nav-item">
            
              <a href="/2018/10/09/dubbo深入（一）基本使用初探/" rel="next" title="">
                <i class="fa fa-chevron-left"></i> 
              </a>
            
          </div>

          <span class="post-nav-divider"></span>

          <div class="post-nav-prev post-nav-item">
            
              <a href="/2018/10/09/dubbo深入（四）- 集群架构设计/" rel="prev" title="">
                 <i class="fa fa-chevron-right"></i>
              </a>
            
          </div>
        </div>
      

      
      
    </footer>
  </div>
  
  
  
  </article>



    <div class="post-spread">
      
    </div>
  </div>


          </div>
          


          

  



        </div>
        
          
  
  <div class="sidebar-toggle">
    <div class="sidebar-toggle-line-wrap">
      <span class="sidebar-toggle-line sidebar-toggle-line-first"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-middle"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-last"></span>
    </div>
  </div>

  <aside id="sidebar" class="sidebar">
    
    <div class="sidebar-inner">

      

      
        <ul class="sidebar-nav motion-element">
          <li class="sidebar-nav-toc sidebar-nav-active" data-target="post-toc-wrap">
            文章目录
          </li>
          <li class="sidebar-nav-overview" data-target="site-overview-wrap">
            站点概览
          </li>
        </ul>
      

      <section class="site-overview-wrap sidebar-panel">
        <div class="site-overview">
          <div class="site-author motion-element" itemprop="author" itemscope itemtype="http://schema.org/Person">
            
              <p class="site-author-name" itemprop="name">kyssion</p>
              <p class="site-description motion-element" itemprop="description"></p>
          </div>

          <nav class="site-state motion-element">

            
              <div class="site-state-item site-state-posts">
              
                <a href="/archives/">
              
                  <span class="site-state-item-count">133</span>
                  <span class="site-state-item-name">日志</span>
                </a>
              </div>
            

            
              
              
              <div class="site-state-item site-state-categories">
                
                  <span class="site-state-item-count">3</span>
                  <span class="site-state-item-name">分类</span>
                
              </div>
            

            
              
              
              <div class="site-state-item site-state-tags">
                
                  <span class="site-state-item-count">2</span>
                  <span class="site-state-item-name">标签</span>
                
              </div>
            

          </nav>

          

          

          
          

          
          

          

        </div>
      </section>

      
      <!--noindex-->
        <section class="post-toc-wrap motion-element sidebar-panel sidebar-panel-active">
          <div class="post-toc">

            
              
            

            
              <div class="post-toc-content"><ol class="nav"><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-service-dubbo-service"><span class="nav-number">1.</span> <span class="nav-text">dubbo:service(dubbo:service)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-reference"><span class="nav-number">2.</span> <span class="nav-text">dubbo:reference</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-protocol-dubbo-protocol"><span class="nav-number">3.</span> <span class="nav-text">dubbo:protocol(dubbo:protocol)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-registry-dubbo-registry"><span class="nav-number">4.</span> <span class="nav-text">dubbo:registry(dubbo:registry)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-monitor"><span class="nav-number">5.</span> <span class="nav-text">dubbo:monitor</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-applicationdubbo-application"><span class="nav-number">6.</span> <span class="nav-text">dubbo:applicationdubbo:application</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-moduledubbo-module"><span class="nav-number">7.</span> <span class="nav-text">dubbo:moduledubbo:module</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-provider-lt-dubbo：provider-gt"><span class="nav-number">8.</span> <span class="nav-text">dubbo:provider(&lt;dubbo：provider&gt;)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-consumer-dubbo-consumer"><span class="nav-number">9.</span> <span class="nav-text">dubbo:consumer(dubbo:consumer)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-method-dubbo-method"><span class="nav-number">10.</span> <span class="nav-text">dubbo:method (dubbo:method)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-argument-dubbo-argument"><span class="nav-number">11.</span> <span class="nav-text">dubbo:argument(dubbo:argument)</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#dubbo-parameter"><span class="nav-number">12.</span> <span class="nav-text">dubbo:parameter()</span></a></li></ol></div>
            

          </div>
        </section>
      <!--/noindex-->
      

      

    </div>
  </aside>


        
      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="footer-inner">
        <div class="copyright">&copy; <span itemprop="copyrightYear">2018</span>
  <span class="with-love">
    <i class="fa fa-user"></i>
  </span>
  <span class="author" itemprop="copyrightHolder">kyssion</span>

  
</div>


  <div class="powered-by">由 <a class="theme-link" target="_blank" href="https://hexo.io">Hexo</a> 强力驱动</div>



  <span class="post-meta-divider">|</span>



  <div class="theme-info">主题 &mdash; <a class="theme-link" target="_blank" href="https://github.com/iissnan/hexo-theme-next">NexT.Mist</a> v5.1.4</div>




        







        
      </div>
    </footer>

    
      <div class="back-to-top">
        <i class="fa fa-arrow-up"></i>
        
      </div>
    

    

  </div>

  

<script type="text/javascript">
  if (Object.prototype.toString.call(window.Promise) !== '[object Function]') {
    window.Promise = null;
  }
</script>









  












  
  
    <script type="text/javascript" src="/lib/jquery/index.js?v=2.1.3"></script>
  

  
  
    <script type="text/javascript" src="/lib/fastclick/lib/fastclick.min.js?v=1.0.6"></script>
  

  
  
    <script type="text/javascript" src="/lib/jquery_lazyload/jquery.lazyload.js?v=1.9.7"></script>
  

  
  
    <script type="text/javascript" src="/lib/velocity/velocity.min.js?v=1.2.1"></script>
  

  
  
    <script type="text/javascript" src="/lib/velocity/velocity.ui.min.js?v=1.2.1"></script>
  

  
  
    <script type="text/javascript" src="/lib/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
  


  


  <script type="text/javascript" src="/js/src/utils.js?v=5.1.4"></script>

  <script type="text/javascript" src="/js/src/motion.js?v=5.1.4"></script>



  
  

  
  <script type="text/javascript" src="/js/src/scrollspy.js?v=5.1.4"></script>
<script type="text/javascript" src="/js/src/post-details.js?v=5.1.4"></script>



  


  <script type="text/javascript" src="/js/src/bootstrap.js?v=5.1.4"></script>



  


  




	





  





  












  





  

  

  

  
  

  

  

  

</body>
</html>
